Release 10.1A: OpenEdge Application Server:
Administration

Installing and configuring Web servers and Java servlet engines

AIA supports the Sun Java Servlet specification Version 2.1 and requires a Web server that is compatible with a Java servlet engine (JSE). The Web server and servlet engine are not provided by OpenEdge. To use AIA, you must install and configure a Web server and a JSE. Table 3–1 lists the Web servers, servlet engines, and platforms on which AIA has been qualified. Other JSEs might work, but have not been qualified. If you encounter problems using a JSE other than those listed in Table 3–1, you should test with one of the qualified JSEs. For more recent information, see your Release Notes and the Progress Knowledge Base on the Web (http://www.progress.com/support).

Table 3–1: Qualified Web Servers and Java Servlet Engines

Web server	Java servlet engine	Platform
Apache	Tomcat	All
iPlanet/Netscape	Jrun™ and ServletExec	All
Internet Information Server (IIS)	Jrun and ServletExec	Windows

A JSE must be installed for each Web server that you are using. How the JSE is installed and configured to run AIA depends on the JSE and the Web server. The information you provide during the installation and configuration varies depending on the Web server and JSE. However, the following reflects some of the tasks you must perform and the information you must provide when you install and configure a JSE for the AIA:

Add OpenEdge-Install-Directory/java/aia.zip to the JSE CLASSPATH.
On UNIX platforms only, add OpenEdge-Install-Directory/lib to the JSE LIBRARYPATH.
Create a servlet instance for each AIA entry in the ubroker.properties file, and use com.progress.aia.Aia for the ClassName property. Then use the following values for the Init Arguments for each instance of the servlet:
InstallDir = Directory where OpenEdge is installed.
instanceName = Name that you specified for the AIA instance in the ubroker.properties file.
PropertyFileName = Location of the ubroker.properties file. This would typically be OpenEdge-Install-Directory/properties/ubroker.properties.
Optionally set up a virtual path extension to point to AIA. For example, you could use a virtual path of /aia/Aia. Progress Software Corporation strongly recommends that you define a virtual path.
Note: The values you enter are case sensitive, so you must enter the values to meet the requirements of the platform you use.

On UNIX only, you must add the following environment variables to the script that starts the JSE:

Add:

DLC=OpenEdge-Install-Directory; export DLC

Add:

WRKDIR=OpenEdge-working-directory; export WRKDIR

Note: This is the path to the work directory you specified when you installed OpenEdge.
Add:

LD_LIBRARY_PATH = OpenEdge-Install-Directory/lib:$LD_LIBRARY_PATH; export LD_LIBRARY_PATH

Note: Depending on your operating system, the library path variable might differ (for example, LIBPATH, SHLIB_PATH, and so on).

You must restart your JSE and Web server for these changes to take effect. After you have completed these steps, test the AIA configuration using a Web browser with the following URL:

Syntax

http://Host:Port/Path

Host

Identifies the machine where the Web server is running.

Port

Identifies the port number for the Web server.

Path

Identifies the virtual path and servlet name used to invoke the JSE and the AIA and must include the following information:

A virtual path that the JSE has configured within the Web server to recognize and pass directly to the JSE instead of looking for that directory on the Web server.
Name of the Java servlet to be invoked by the JSE.

The specification of the Path depends on your Web server and JSE. For more information, see the "Configuring AIA components" section and the documentation for your Web server and servlet engine.

If you used all the recommended settings, the URL is:

http://Host:Port/aia/Aia

For instructions on installing and configuring a specific JSE, see the documentation for that JSE. For more specific information about configuring the AIA with JSEs, see the Release Notes and the Progress Knowledge Base on the Web (http://www.progress.com/support). For information about the configuration tasks you must complete to use the AIA with WebClient, see the Progress Knowledge Base on the Web (http://www.progress.com/support).